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This manual describes problems that can arise during normal use of die UNIXf 
system and a number of its utility programs. 

NOTE This manual does not cover procedures for system maintenance, malfunctions, or 
troubleshooting. For information about those topics, refer to for information 
about these topics. 

Chapter 1 is an introduction. It includes a list of important problems, and steps to 
prevent or work around them. 

Chapter 2 describes problems logging in and out. 

Chapter 3 describes error messages that can happen when running commands and 
what they mean. 

Chapter 4 describes error messages for selected commands. 

Chapter 5 describes problems and error messages that can occur when editing 
text files. 

Appendix A describes error messages that can occur when using remote systems 
over the network. 
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Introduction 



When you begin using any new piece of equipment, problems can arise that seem 
to require prior experience to avoid or correct. Remember your first few 
encounters with a sewing machine or with car repairs? 

A bit of guidance can be most helpful when you know what you are trying to 
accomplish, but have hit a snag. This manual is intended to provide you with 
pointers to get through the sorts of problems that many beginners find perplex- 
ing. The majority of problems most users face stem from simply not knowing 
what to do in a given situation. 

NOTE This manual describes basic problems that can confront the beginning user who 
lacks experience with a powerful operating system such as UNIX. It is not 
intended to resolve problems with installation, internal operation, or diagnosis 
of equipment or software. Refer to System Administration for the Sun Worksta- 
tion/or information about system maintenance and related topics. 

This chapter describes initial steps for dealing with any problem, lists some of 
the most serious ones you may encounter, and describes what you can do about 
them. Subsequent chapters deal with problems that may come up when perform- 
ing activities, such as logging in and out, running commands or editing files. 

1.1. Discovering A Problem There is never a convenient time to discover that you have a problem. As a 

beginning user, a problem typically comes to your attention when the system 
displays a message such as: 

File not found. 

Command not found, 
or 

Permission denied. 

Messages like this can be both perplexing and disturbing, but there is a reason 
behind each one. Often, the reason becomes obvious as soon as you think about 
it, but sometimes it takes a bit of detective work to figure out. 

Since detective work can be difficult 
when you don’t know where to look, 
it may help to befriend an 
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experienced user who can diagnose Whenever a problem occurs, there are some steps that you can take to minimize 
zling' emS ^ at are espec ' al ' y puz ' the intermption and prevent any further complications from arising. 

When you are confronted with an error message , stop what you are doing for a 
moment. Make note of what you are trying to accomplish and how far along you 
were when the problem came up. Then note die command that resulted in the 
error message (in most cases the command that you just typed in). This will 
come in handy if you have to ask you System Administrator 1 or a more experi- 
enced user for help. This will also make it easier for you to pick up from where 
you left off should you need to play detective. 

The vast majority of error messages come as the result of mistyping a command 
or filename. So, check the command line for spelling errors and typos. 

Another common problem, even among experienced users, is being in the wrong 
directory when you type in a command. Check to see what directory you are in 
with pwd. 

If you have occasion to use another person’s account, you may have forgotten 
which one you are currently using. When you are logged in as someone else, 
files that belong to your account may not accessible. Check to see which account 
you are using with whoami. 

If the steps so far haven’t revealed the source of the problem, then you are going 
to have to do some digging. So, along with your note about what you were doing 
when the problem occurred, copy down the error message exacdy as it appears. 
This information will be important to you as you look for answers in this manual, 
and vital to anyone trying to help you. 

By following these steps, you will have gathered enough information to answer 
the important questions of: 

What? What, exactly, was the error message? 

When? At which stage in your work did the problem arise, and with which 
command? 

Where? What directory were you in? 

Who? Whose account were you using? 

This makes the questions of "Why did the problem arise?", and "How can I 
correct it?" much simpler to track down, especially when you need to get expert 
help. 



1 If your Workstation is equipped with its own disk drive, then you may be able to perform tasks that we 
indicate should be referred to the System Administrator. These tasks are described in System Administration for 
the Sun Workstation . 
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1.2. Worst Cases 



Deleted Data or Files 



It is a good idea to check with your 
System Administrator about the 
backup schedule for your system. 



We assume that you are using the 

^ ii 

o-onen. 



Step 1 : Stop. Make a note of what you are trying to accomplish and how far 

along you are. Make note of the specific command that resulted in 
the error message. 

Step 2: Check the command line for typing errors. 

Step 3: Check to see what directory you are in with pwd. 

Step 4: Check to see which account you are using with whoami. 

Step 5: Take down the error message exactly as it appears. Check this 

manual for answers, and if necessary, get help from your System 
Administrator or an experienced user. 



One problem that almost all beginners seem to face is anxiety about making a 
disastrous mistake. The fear that one may accidentally destroy valuable files or 
bring the system crashing down as unnerving as it is exaggerated. (It takes more 
knowledge than most beginners have to do any serious harm). But, it only 
natural to be apprehensive when you aren’t sure of the risks involved. 

Perhaps the best way to overcome this anxiety is to learn right what the realistic 
risks there are, and what you can do to minimize them. 

It is possible to remove or erase the contents of a file unintentionally, but there 
are simple steps that you can take to help prevent this from happening. It is also 
possible to make the system crash (say, by unplugging your mouse and then 
plugging it back in), but it is normally quite easy to start it back up again. 

Perhaps the worst problem that you will encounter as a beginner is the accidental 
deletion of a file or a portion of its contents. Once removed, a file is gone for 
good, and the same is tree for any contents that you erase. 

Your System Administrator should be making regular backup tapes of all files 
that change, and can usually recover a recent copy of the 

file containing all but the current day’s work. Still, losing a full day’s work on an 
important file can be a big disappointment 

You can take the following steps to prevent your files from being accidentally 
deleted or overwritten. 2 



If not already contained in your . cshrc file 3 cd, to your home directory and 
insert the following lines at the beginning: 



f 






set noclobber 






alias cp 


'cp -i' 




alias rm 


' rm -i' 




alias mv 


'mv -i' 




v 







3 Refer to Setting Up Your UNIX Environment for more information about this file. 
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The set noclobber command prevents existing files from being overwritten 
when you use the > symbol to redirect output. The alias commands indicate 
that cp, rm and mv are to run with the — i option — to ask you for confirmation 
before removing or overwriting existing files. 

To make sure that these commands take effect immediately, type 

source .cshrc 

on your terminal, or in each cmdtool or shelltool window currently run- 
ning. 



Be sure to open any windows that 
are iconic and run this command in 
them as well. 



< > 
Step 1 : Insert the lines 



set noclobber 




alias cp 


'cp -i 


alias rm 


'rm -i 


alias mv 


'mv -i 


in your .cshrc file. 





Step 2: Run the command source . cshrc in every shelltool or 

cmdtool window, or on your terminal. 



System Shutdown If your System Administrator should need to take the system down while you are 

using it, you may see a broadcast message telling you that the system is about to 
shut down. Whenever the the system shuts down, it automatically saves files that 
you are editing with vi. 4 Even so, it is a good idea to type I ESC I : wq as soon 
as you see the broadcast message. 

If you are running other programs and want to make sure that the most recent 
data is saved, type in the sync command. 

> 

mars% 

Broadcast Message from mars! root (console) at 12:44 ... 

System Going Down Immediately! 

sync 

mars% 

v > 



To recover the file you were editing after the system has come back up, cd to the 
directory you were in at the time of the crash, and type in the command: 

vi -r filename 

Then, before you do anything else, type in the command: 

: w 

This assures you that the recovered version is properly written out. 

4 also ex and ed. 
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System Shutting Down: 

Write and quit from vi when you see the broadcast message, or use 

the sync command to force data to be saved. 

System Comes Back Up: 

Step 1 : cd to each directory containing files you were editing 

and: 

Step 2: Use vi -r to recover preserved files. 

Step 3: vi displays the date the file was preserved on its mes- 

sage line, after checking this date, type in the command 
: w to assure that the preserved version is saved. 



System Crash If the system crashes , or shuts down unexpectedly, files that you are editing are 

preserved as indicated above. Should this happen while you are using the 
Workstation itself, the windows and mouse will cease to function and messages 
such as those shown below will appear at the lower left of the Workstation 
screen. If you are logged in on a terminal, things will simply come to a halt. 

If you are logged in at a terminal Abort at 004832 

when the system crashes, contact 

your System Administrator for or 

assistance. 

panic : condition 

If the message says panic this doesn’t mean that that you should. It means that 
the system’s internal software encountered some sort of rare and unusual error 
condition. The condition often clears up when you start the system back up. 
Even so, it is a good idea to take down the entire message for your System 
Administrator’s information before proceeding to restart the system. Even when 
the system comes back up successfully, it is best to report any panic messages 
to your System Administrator. 

The message is followed by a right angle-bracket (>). This is the monitor 
prompt. To restart (or reboot ) the Workstation, type in the monitor command b 
when you see this prompt. 

You may save time by typing in a c 
instead. This tells the monitor to 
pick up where it left off instead of 
starting over from scratch. Then, to 
unscramble the window display, use 
the "Redisplay All" item in the "Sun- 
tools" menu. 




5 Sometimes the system has to verify its data when it comes up again, and this can take up to IS minutes 
more or less. If you you don’t get a login prompt by then, contact your System Administrator for assistance. 
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Unresponsive Terminal 



. 

Step 1 : If die word panic appears in the error message, take down what the 

message said. 

Step 2: When the monitor prompt appears, type in b (or c) to restart the sys- 

tem. 

Step 3: If the system hasn’t prompted for login in 15 minutes or so, contact 

your System Administrator for help. 

Step 4: Perform the steps in the previous section under System Comes Back 

Up 





When the terminal (or cmdtool or shelltool window) gets confused or 
hung, there is often no error message. Instead, terminal may not display things 
properly. It may display only its prompts and messages but not what you type, or 
it may display only what you type and nothing else. This sometimes happens 
when you interrupt an interactive game with t CTRL-C1 . 

To clear the terminal or window, use the reset command as follows: 
r \ 

1 1 JNF.FF.ED I 
reset 
1 LINEFEED I 

J 



Even if the terminal doesn’t display anything, it often recognizes this command, 
and clears up. Use 1 LINEFEED I rather than t RETURN) , because when it is con- 
fused, the terminal may not recognize [ RETURN I properly. 

If this doesn’t clear things up and the problem is with a cmdtool or 
shelltool window, you may have to quit the window and open a new one. If 
the problem is with a terminal, you may have to get help from your System 
Administrator. If you are logged in on a remote terminal over the phone lines, 
you may have to log out and dial in again. 

— — — N 

Step 1: Type in 

[LINEFEED! 
reset 
I LINEFEED) 

Step 2: If the window is still not working properly, quit that window and 

open another from which to work. If using a remote terminal, log out 
and then back in again. If using a local terminal contact your System 
Administrator. 

^ 
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2.1. Can’t Log In 



Account Not Set Up 



Can’t Remember Password 



Terminal Control Characters 
In Password 



Capitals in the Username 



Problems with Logging In, Logging Out 

and Passwords 

In order to log in to the system, you must have an account set up for you by your 
System Administrator. If this hasn’t been done yet, or if a mistake is made when 
setting up an account, you may not be able to log in. Problems with logging out 
can come up when you have stopped jobs, or when you attempt to log out from 
within a different shell (such as a shelltool window) than the one you logged 
in on. 

There is generally little that you can do about not being able to log in except to 
contact your System Administrator and wait for her or him to correct the prob- 
lem. 

If you have no account on a system, you cannot log in to it If your system is 
connected to a network that uses the Yellow Pages network services, however, 
once your account is set up, it may be recognized by other machines on the net- 
work as well as your own. See Using the Network for more information, and 
check with your System Administrator to be sure. 

If you forget your password, you cannot log in. You must ask your System 
Administrator to change your password to something that is easy for you to 
remember. Once you can log in, you may want to change your password again 
so that it is known only to you. In general, long sequences of numbers, punctua- 
tion marks and other special characters are hard to remember, whereas words that 
evoke some meaning to special only to you are easier to remember. 

Although you can use any character in your password, characters can be inter- 
preted as signals by the terminal such as I CTRL-Cl . 1 CTRL-Z) . [ CTRL-U1 . 
f CTRL-$ ) . tESCl . f TAB] , and in some cases CD and I @1 should be avoided. 
The terminal may interpret these as signals rather than text characters, and this 
would preclude you from typing in the password correctly. 

If you type your username in capitals when you log in, the system will behave as 
if the terminal is "upper-case" only. All letters will be displayed in upper case. 

To avoid this, leave capital letters out of your username when you log in. 
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Misspelled Username or 
Mistyped Password 



No Home Directory 



No Shell 



Error Messages at Login 



2.2 . Can’t Log Out 



Not Login Shell 



Stopped Jobs 



If you see the message 
Login incorrect 

try again. You may have miskeyed something. If, on the third try you still aren’t 
logged in, see your System Administrator. 

If you see the message 

No Directory! Logging in with home=/ 

This means that there is no directory set up for your use on die system. If this 
happens when you log in to another machine on the network, it may not matter. 
But if this happens when you log in to your own system, then you need to contact 
your System Administrator to set up a home directory for you. 

If you see the message 
No shell 

then an error was made when you account was set up. Consult your System 
Administrator. 

If you see an error message whenever you log in, there is probably an error in 
your .login file. If you see an error message whenever you start a new 
shelltool or cmdtool window, then there is probably an error in your 
. cshrc file. Since these files contain commands like those that you can type in, 
they are not too difficult to correct Refer to Setting Up Your UNIX Environment 
for more information about these files, and to Doing More With UNIX for more 
information about commands that they contain. 

When you use the window system on your Workstation, you are logged in as 
long as suntools is running — even if you quit from every window in the 
display. Use the "Lock Screen" item in the "Suntools" menu to secure the works- 
tation against unauthorized use, or exit from suntools and then type logout. 

If the message 
Not login shell 

appears when you attempt to log out, you can use the exit command to kill the 
current shell, shelltool, or cmdtool. 

If the system responds with the message 
There are stopped jobs . 

then use the jobs command to see which commands are waiting. If you don’t 
care about any of them, a second command to log out will have the desired 
effect, and will terminate the stopped jobs as well. Refer to Doing More With 
UNIX for more information about jobs, stopped jobs, and job control in the C- 
Shell. 




Revision: A of 17 February 1986 




13 



2.3. Can’t Change Password 



Network Access: Your YP 
Password 



When you use pas swd to change your password, you must enter the old pass- 
word correctly, or it will reply with 

Sorry. 

and your password will remain the same. 

If you use the su command to assume another user’s identity , 6 you cannot 
change that user’s password. Nor can another user change your password after 
gaining access with su. 

The Yellow Pages network services maintains a separate list of user accounts and 
passwords for everyone with access to the network. When you log in to another 
machine and are prompted for a password, it is asking you for your YP password 
(which may be different than that on your current machine). 

To change your YP password, use the command yppasswd. This command 
works just like pas swd. As you are prompted to do so, type in your old YP 
password, your new YP password, and then confirm the new YP password. If 
you don’t know your YP password, the System Administrator for your network 
can issue you a new one. 



See Doing More With UNIX for more information. 
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Problems Running Commands 



Because there are error messages specific to every command, attempting to 
describe each and every one would only obscure those that are more general in 
scope. In this chapter we describe error messages that may come up when using 
just about any command. The next chapter describes those issued by selected 
commands that are used most often. Appendix A lists error messages that can 
arise when using the network to gain access to other machines. 



3.1. Problems with Command 
Line Syntax 



r~ 


. arg count 


\ 


y 




j 



You specified either too many, or too few arguments for the command. 



r 


A 


Arg list too long 






J 



Your command substitution 7 expanded to form a command line of more 
than 10240 characters. This can happen when you use the cat command 
within backquote marks ( '). 



Broken pipe 



The command that was receiving data from a pipe terminated before the 
command sending data finished. This usually means that the second or sub- 
sequent command encountered an error and died. You may have to look up 
commands in the pipeline in the Commands Reference Manual to figure out 
what went wrong. 



r 


A 


File exists 




s 


-J 



7 See Doing More With Unix for more information. 
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The command attempted to overwrite an existing file. Move the existing file 
to a new name with mv, or remove it with rm, and run the command again. 



File name too long 




Your filename expansion string somehow expanded to a pathname with a 
component (directory-name or filename portion) exceeding 255 characters, 
or to a pathname exceeded 1023 characters. Try specifying the pathname 
explicitly. 



File not found 



The file you attempted to look up or get access to is not in the directory. 
Refer to the discussion of find in Doing More With UNIX for information 
on how to look up a file when you don’t know the directory it is in. 



File too large 

9 

The size of a file exceeded the maximum (about 10 bytes). If you see this 
message, consult your System Administrator immediately. 

Is a directory 



You attempted to read or write on a directory as if it were a regular file. 
(Can happen to anyone). 

... No match 



The filename substitution pattern you gave did not match any files. 



No such file or directory 

This error occurs when a named file does not exist, or when one of the 
directory-names in a pathname does not exist. 



Not a directory 




#sun 

V microsystems 



Revision: A of 17 February 1986 















Chapter 3 — Problems Running Commands 1 9 



You supplied the name of a file to a command that expects a directory, such 
as cd. 



r 


a 


Not owner 






j 



You tried to access or change permissions of a file that you don’t own, you 
attempted to kill a process that you don’t own, or, you attempted to run a 
command that can only be run by the superuser (root). Refer to "Processes 
and Other User’s" in Doing More With UNIX for more information. 



Out of memory 

/ 



There are too many processes taking up memory on your Workstation. If the 
system’s performance is still good, then a good many processes may be idle 
and unnecessary. Use ps and kill to terminate idle processes that you 
own. Refer to Doing More With UNIX for more information about processes. 



r 


A 


Permission denied 




V 





You attempted to either read, write, or execute a file for which you lack the 
proper permission. Refer to "Files" in Doing More With UNIX for more infor- 
mation about files and permissions. 



. 

... Stale NFS file handle 

> _ / 



The rag got pulled out from under the file you were using. The file is in a 
remote-mounted file system that got unmounted by its host system (perhaps 
by a crash of that host), or someone on another machine removed it, or 
moved a new version into it while your command was still running. Do an 
1 s on the directory to see if the file is still there. If the file is there, and its 
contents are what you expect, then reran the command. 

If the file is missing, or its contents are unfamiliar, then you may need to get 
the version you need restored from backup. Files that are accessible from 
more than one machine may need to be protected using sees to prevent col- 
lisions like this. Refer to Doing More With UNIX for more information about 
secs. 

If no files are listed then have the System Administrator remount the filesys- 
tem on the remote host, and then ran the command again. 
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Too many arguments 



The command you used expected fewer arguments. For instance, you can 
cd to only one directory. 

' — ' — ■> 

Too few arguments 

- - - j 

The command you used expected more arguments. For instance, mv 
requires a minimum of two arguments: a filename and its new name. 

> 

Too many levels of symbolic links . 
/ 

A pathname lookup involved more than 8 symbolic links. To reduce the 
number of symbolic links needed to resolve the pathname, use Is -1 to 
look up the filename pointed to by the symbolic link. Then supply that 
name to Is -1, and so on until you reach the file or directory. 

Too many links 

) 

You can have only 32767 hard links to the same file. Actually, if you see 
this message it could indicate that someone mistakenly made all those links. 
It is a good idea to report this to your System Administrator so that the prob- 
lem can be corrected. 



Usage: ... 

You typed in the command incorrectly, and it responded with a syntax 
diagram as a brief reminder. 

... Unknown option 

The option you specified is not valid for the command you typed. Refer to 
the Commands Reference Manual for a list of valid options for the com- 
mand you typed. 

Unknown error 
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The system encountered something very strange. Contact your System 
Administrator immediately. Do not attempt to correct this yourself. Your 
System Administrator needs to see the exact sequence of events leading up 
to this error message. 



3.2. Unforeseen Conditions 



Disc quota exceeded. 

V J 



You attempted to write on a file, create a new file, or create a new directory 
that would exceed your disc quota. 



Read-only file system 



You attempted to write on a file or in a directory within a filesystem that is 
mounted read-only. 



r 

... write failed, file system is full 




v 


j 



There is no more room in the named filesystem. This message can come up 
when there extremely large print jobs in the printer queue and you are run- 
ning programs that use temporary files (such as vi) on a diskless Worksta- 
tion. Both the printer queue and the / tmp directory may in the same 
filesystem, which gets filled up with data for the printer. The solution is 
either to remove one or more print jobs or wait until those print jobs finish. 
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cat 



cd 



chmod 



Problems with Selected Commands 



To interpret an error message produced by a specific command not contained in 
this list, refer to that command in the Commands Reference Manual . 




Either you are in the wrong directory, the file does not exist, or you do not 
have permission to read it 




You cannot cat the contents of filename to itself. 




You do not have permission to change to pathname. 




You attempted to change permissions of a file or directory that does not 
exist. You may be in the wrong directory. 




You attempted to change permissions on a file you don’t own. 
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cp 



date 



df 




You specified the new permissions incorrectly. Perhaps you typed filename 
ahead of the permissions argument. 




The file specified by filename either doesn’t exist, or it does not have read 
permission. 




The two filename arguments to cp must represent different filenames. 




This usually indicates that you are in a directory which you don’t own, or 
you are trying to create a file in a directory for which you don’t have write 
permission. 




You must be the superuser (root) in order to set the date. 




The filesystem or device you specified is not accessible. 
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diff 



grep 



kill 



Something is wrong in the file system. Notify your System Administrator 
and do not try to fix this yourself. 




Use the -h option when running diff on huge files. 




You supplied an option that grep does not recognize. Refer to grep in the 
Commands Reference Manual for a list of valid options. 




The search pattern, or ( regular expression ) on the command line is too long 
for grep to handle. You must shorten the expression, perhaps by performing 
the search in stages using several grep commands within a pipeline. 




You specified regular expression (search pattern) incorrectly. 




Either filename does not exist, or you do not have read permission for it. 




Either the process does not exist, has terminated, or is owned by someone 
else (in which case you cannot kill it). 
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You attempted to create a hard link to a file in another filesystem. 




The file named by the first argument does not exist. 




A file by the name contained in the second argument already exists. 




Use the -s option to make a symbolic link to a directory. 




You do not have read permission for directory. 




Some options of the Is command sort the filenames before displaying them. 
This message occurs when there is not enouch memory available to perform 
the sort. Use ps and kill to eliminate extraneous (idle) processes. See 
Doing More With UNIX for more information. 




Revision: A of 17 February 1986 











Chapter 4 — Problems with Selected Commands 29 



make 


/ 

Don't know how to make target 






k. 





You asked make to process a target not contained in your makefile. 



mkdir 


r 

mkdir: cannot access directory 


> 






j 



directory does not exist or you don’t have read access to its parent. This 
may come up should you try to create a subdirectory before its parent direc- 
tory is created, Also appears when the parent directory does not have write 
access. 

mkdir: cannot make directory dir 
The directory specified by dir already exists. 



man 


r 


> 


No entry for item ... 






v 


j 



There is no entry for the item you asked for in the online Manual Pages, or 
in the section you specified. 



mount and umount 



r 

Block device required 


N 

J 


You tried to mount something other than a filesystem. 




r 

Mount device busy 


A 


l 


/ 


You attempted to mount filesystem that is already mounted, or to dismount a 
device on which there is a file in use. 


r 

You must be root to use mount 


A 


V — - — — 


J 



You must be logged in as root (the superuser) to use these commands. If 
you know the root password for your Workstation, use su -f to quickly 
"become root" and run the command. Commands in Section 8 of the Com- 
mands Reference Manual are typically run by root. 
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. 

Too many levels of remote in path. 
_> 



You attempted to mount a remote filesystem within another remote-mounted 
filesystem. 



mv 



can't mv directories across file systems 



Use cp -r to copy the directory, its files, and any subdirectories (with their 
files) to the new location. Then use rm -r to remove directory and its files 
from the old location. 



mv: directory rename only 



This message appears if you type a command of the form: 
mv filename olddir newdir 

You can either move a list of filenames to a new directory, or move a single 
directory to a new name, but not both in the same command line. 





mv: cannot unlink filename 

/ 



Usually arises because you are not the owner of the directory containing 
filename. 



mv: cannot move a directory into itself 



The source and destination directory names must be different. 



pwd 



r 


N 


pwd: cannot open . . 




v 


J 



The parent directory has somehow become read protected, and pwd com- 
mand cannot read it to determine the pathname of the current directory. This 
can happen when you have more than one cmdtool or shellt ool win- 
dow open and, from within another window, you change the permissions of 
any directory in the pathname of the current directory. 
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rm -r and rmdir 



There are still files in the directory. Use Is -a to see them all. 




Either you lack write permission for the directory that contains the file, or 
you did not answer with a y when asked for confirmation to remove the file. 




You are not allowed to remove the parent of the current working directory. 




You are not allowed to remove the current working directory. 



troff and nroff 



Refer to Out of memory, above. 




A closing macro was missing. Use checknr to obtain a list of possible for- 
matting errors. The message core dumped indicates that the system 
copied an image of the process where it left off for further diagnosis, if 
needed. 
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Either trof f was not properly installed on your system or network, your 
system uses a local version, or the phototypesetter is temporarily unavail- 
able. Consult your System Administrator to find out which is the case. 
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Problems Editing Text Files (with vi) 



As the standard UNIXt text editor, vi is one of the first programs introduced to 
you in Getting Started With UNIX. Few text editing programs can match it for 
power, or for a better "fit" within UNIX. It is, however, by no means the only text 
editor available. Along with several line editors such as ex and ed, the 
window-based editor text edit , offers some very attractive features. 8 You can- 
not, however, use textedit on a terminal other than the Workstation, or when 
you rlogin to another machine to edit files that reside there. In these cases, 
you may need to use vi. 



Or, rather than using rlogin, to 
get access to files on another sys- 
tem, you can su to become root 
on your system, then mount the 
directory containing the files you 
want. Once mounted, you can use 
that directory just like any other 
directory on your system. Refer to 
mount in the Commands Reference 
Manual for more information. 



So, even if you adopt another editor as your favorite, you may still have occasion 
to use vi. 

When you can solve the sorts of problems that may arise with vi , you will be 
better equipped to resolve problems with whatever editor you may use. 



5.1. Operating Problems The problems described in this section require you to perform specific tasks in 

order to avoid losing text or changes made since the file was last written. 

Deleted Wrong Text or Need When have made several deletions, such as when you use dd successively delete 
Previously Deleted Text to lines, you may find that you want some of the deleted text back again. If you 

want the most recently removed line, you can use u to restore it. But suppose 
you want to undo the 3’rd to the last deletion? 

When you delete text (of a line or more), vi saves that text in a buffer . There 
are nine numbered buffers that contain up to the 9’th most recent deletion. To 
recover the n ’th most recent deletion, use the p command as follows: 

"n p 

When you delete a word or portion of a line, this text is not saved in a buffer. If 
you want to recover it, say, after adding some more text (in which case u won’t 

t UNIX is a trademaik of AT&T Bell Laboratories. 

8 See Windows and Window-Based Tools for more information. 
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Nested Editing Sessions 



CAUTION 



work) use p. 

The : ! shell escape allows you to run UNIX commands from within ofvi . One 
vi. Because vi works on a copy of the file, when you have it running it more 
than once on the same file — at the same time — you can lose data. It is possible 
to make changes in one session, write them, then exit to the other session which 
knows nothing about the changes you just made (since it is working on its own 
separate copy that was created prior to your most recent write command), and 
overwrite these more recent changes. 

Try this on a test file to see how it can happen: 

Do not run this test on a file containing information of any value. 



Make a copy of a file and call it test. Run vi on the file. 



/ 


\ 


mars% cp memo test 




mars% vi test 




[ vi screen comes up ) 




V 


j 



Now, use : ! to run vi again. When the new vi screen comes up, delete its con- 
tents with thendG, vi session with : wq . 



r 


a 


: ! vi test 




[ vi screen comes up ) 




dG 




f text is deleted 1 




: wq 




[ orevious text comes up 1 




\ 


> 



At this point you can check to see that the written-out version of the file has less 
text by running the command : ! more test 



r 


\ 


: ! more test 




|Hit RETURN to continuel 




v 


J 



After typing I RETURN) , write and quit, then run more test from the C-Shell. 
Lo and behold, the contents are back! But what would have happened if you had 
added text rather than deleting it in the "inner" vi session? 

When you use I CTRL-Z I and job control 9 to alternate between vi and the C- 
Shell, remember not to ran vi a second time on the same file as that in stopped 
session. If you do, and if you write out your changes, then use kill to 



9 See Doing More With UNIX, for details. 
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terminate the stopped session, or resume editing and exit from that session with 
:q!. 

Recovered Wrong Version If you type in the -r option, and die file you are editing was once preserved dur- 

ing a crash (but not yet recovered), vi will recover this older, and probably out- 
dated version. If the date displayed for the file does not correspond to the most 
recent crash, do not write the file and do not edit it. Rather, check the file very 
carefully to see if it is up to date. If it is not, then use : q 1 to exit immediately 
from vi. Or, if in doubt, use 

:w filename. REC 

to save the recovered version. You can then exit vi and run dif f to compare 
the two versions of the file. 

If you have already typed : w, you may have to have the System Administrator 
recover the more recent version from backup tape. 

Can’t Write Changes When you edit a file for which you don’t have write permission, you can still 

make changes to the temporary copy vi uses. If you don’t own the file, you can 
write out a modified copy by supplying a filename to the : w ! command: 

: w ! filename 

If you have write permission on the directory, you can exit vi and use mv to 
replace the existing version of the file with your modified version. 

If you own the file, you can force the changes to be written out, even though vi 
complains. To force the changes to be written, use the command 

: ! chmod +w % 

to give yourself write permission on the file. The percent sign is a symbol that 
stands for the name of the file currently being edited. Then use 

:w! 

to force the changes to be written. Of course, if you don’t own the file, this won’t 
work. 

Ran Out of Disk Space If, when you attempt to write a file, you get a message that the file system is full, 

then you will need to find another filesystem with more space. Use the command 

: ! df 

to see which filesystems have space available and pick a directory in one of them. 
To write the contents onto a new file in this other directory, use the command 

: w ! pathname 

Next, notify your System Administrator about the full disk, so that she or he can 
move some of the files to another disk or remove them to tape. 

If you get a message indicating that your disk quota has been reached, you may 
either have to forego writing your changes, or go searching for files to remove 
instead. Tf yon am logged in on a terminal, you can use I CTRL-Z J to suspend vi 
while you hunt for files to remove. You can use % to resume vi where you left 
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Truncated or "Skipped" 
Lines, or Cursor Tracking 
Errors 



vi Comes Up as ex 



Bug: Repeating an Insertion 
with an Embedded Word 
Wrap 



5.2. vi Error Messages 



Problems Starting Up 



off. 

If the system drops from vi into open mode and indicates a file system is full, 
this means that the disk containing vi’s temporary files filled up. Use the com- 
mand 

! Is / tmp 

to see if there are files that you can remove. If you have queued up large print 
jobs, you may have to remove some of them to regain disk space for vi. 

When you r login to another machine, use a standard-sized shelltool win- 
dow. Using a window that is smaller can cause vi to skip the top few lines. If 
you then write out the file, the skipped lines will be deleted. 

If the window is larger than standard, the cursor may not accurately track your 
location within the file, and you won’t be sure of what changes you may be mak- 
ing. 

If either of these should happen to you, use 
:q! 

to exit vi, and then open a new shelltool window from which to run rlo- 
gin. 

You typed an interrupt signal before vi could draw the screen. Use the com- 
mand vi to begin (or resume) full-screen editing. 

If you insert a long string of text, and then use the dot ( . ) command to repeat the 
insertion, if that repeated insertion extends beyond the end of the line to cause a 
word wrap, vi garbles the text to be inserted. To avoid this problem, use to y 
(yank) and p (put) to replicate the inserted text. 

Should a problem arise during an editing session, vi may display one of the 
messages listed below. 



— 



Bad termcap entry 
Termcap entry too long 
terminal : Unknown terminal type 
Block device required 

c 


/ 


or 


— 


>1 


Not a typewriter 




l 
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vi could not figure out how to work with the terminal you are using. See 
you System Administrator to correct this problem. 



Block special file 


A 


Character special file 




Directory 




Executable 




Non-ascii file 




file non-ASCII 




i 


y 


or 


Bad file number 









The file you attempted to edit was not a regular text file. 



Problems with File Recovery 


r 

Can't fork to execute recovery 







Can't make pipe for recovery 
s 


j 



or 



f 


A 


[Warning - file is incomplete] 




< 


J 



vi was unable to recover all or part of a file preserved after a crash. See 
your System Administrator. You may have to recover an earlier version of 
the file from backup tapes. 



Problems Writing a File 



r 




File exists 




^/e"File exists - use w! 




k 


j 



or 







[Existing file] 

V. - - - 


-J 
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When you specify a file to write with : w filename, vi checks to see if a file 
by that name already exists. If so, you see one of these messages. Use : w ! 
filename to overwrite the file. 




Either you are running view, or you lack write permission for the file. In 
either case, see Can’t Write Changes above. 
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A 



Problems with Network Access 



The following messages indicate a problem accessing a remote system over the 



network. 






Connection refused. 




v 


J 



The remote machine is unavailable at present. 



— 




Connection timed out. 




V 


j 



The remote machine failed to respond within the required time limit. Either 
it is too busy to accept new connections, or it is restarting ( rebooting ) after a 
crash. 



r — - n 

Network dropped connection on reset . 
— 



The host you were connected to crashed and rebooted, dropping the network 
connection to your system. 
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alias cp 'cp -i' for preventing accidental deletion, 6 
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rlogin and vi, 35 
rm, 31 
rmdir, 31 

set noclobber for preventing accidental deletion, 6 
sync, 6 
troff, 31 
umount, 29 
common causes 
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data loss and vi, 35 thru 38 
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Directory, 39 
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Disc quota exceeded., 21 
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F 

File exists, 17, 28, 39 
File is read only, 40 
File name too long, 18 
file non-ASCII, 39 
File not found, 18 
File not found., 3 
File too large, 18 
files 

lost or deleted data, 5 
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recovering editor files after system shutdown, 6 
Files too big, try -h, 27 
forcing data to disk, 6 
full disk and vi,37 

G 

getting help, information needed, 5 
grep, 27 

H 

hung terminal, 8 
hung window, 8 

i 

initial steps for any problem, 5 
Is a directory, 18 

J 

job control and vi, 36 

K 

kill, 27 



L 

LINEFEED key, 8 
In, 28 

In: name is a directory, 28 
logging in over the network, 13 
login problems, 11 thru 13 
logout problems, 11 thru 13 
lost data or files, 5 
Is, 28 

M 

make, 29 
man, 29 
mkdir, 29 

mkdir: cannot access directory, 29 
mkdir: cannot make directory dir, 29 
monitor, 7 
mount, 29 

Mount device busy, 29 
mv, 30 

mv: cannot move a directory into itself, 30 
mv: cannot unlink filename, 30 
mv: directory rename only, 30 

N 

nested editing sessions, 36 
network access problems, 43 
network and editing files, 35 

Network dropped connection on reset., 43 
network password, 13 
No entry for item 29 
No match, 18 

No such file or directory, 18 

No such process, 27 

Non-ascii file, 39 

Not a directory, 18 

Not a typewriter, 38 

Not owner, 19 

nroff, 31 

o 

Out of memory, 19, 28 

p 

panic: condition, 1 

password problems, 1 1 thru 13 

pathname : bad directory, 25 

Permission denied, 19, 40 

Permission denied., 3 

permissions, and writing changes from within vi, 37 

preventing accidental deletion of files, 5 

pwd: cannot open ..,30 

Q 

quotas and vi, 37 
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Read-only file system, 21 

recovered wrong version with vi -r, 37 

recovering editor files after system shutdown, 6 

removed files by mistake, 5 

repeated insertion bug in vi, 38 

restarting system after a crash, 7 

rlogin and vi, 35 

rm, 31 

rmdir, 31 

s 

Segmentation fault .,31 
Stale NFS file handle, 19 
system crash, 7 
system shutdown, 6 

T 

Termcap entry too long, 38 
terminal, unresponsive, 8 
Too few arguments, 20 
Too many arguments, 20 
too many files, 28 

Too many levels of remote in path., 30 
Too many levels of symbolic links., 20 
Too many links, 20 
trof f, 31 

truncated lines in vi, 38 
Typesetter busy., 31 

u 

umount, 29 
Unknown error, 20 
unknown f lag, 27 
Unknown option, 20 
unreadable, 28 
unresponsive terminal, 8 
unresponsive window, 8 
Usage : 20 

v 

vi 

alternating with C-Shell using job control, 36 
vi, 37 

and data loss, 35 thru 38 

and deleted text, 35 

and disk quota, 37 

can’t write out changes, 37 

comes up as ex, 38 

cursor tracking problems , 38 

nested sessions, 36 

problems starting up, 38 

problems with file recovery, 39 

problems with writing a file, 39 

recovered wrong version of file with -r, 37 

repeated insertion bug, 38 

truncated lines, 38 



w 

[Warning -file is incomplete] , 39 
window, unresponsive, 8 
worst cases, 5 

deleted data or files, 5 

Y 

You must be root to use mount, 29 
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